Dialog Box for Timing Settings

The Timing dialog box provides a user-friendly interface for the settings of bean timing features. When clicking on the button of a timing item in the Bean Inspector, the timing dialog box is displayed.

• Target CPU in the Project Panel
• Used peripherals in the bean's properties
• Requested prescaler in the bean's properties, if supported
• Supported speed modes in the bean's properties

Options

Runtime setting type:

• fixed value: it will not be possible to change the timing setting of the bean in runtime.
• from a list of values: it will be possible to select a new value among predetermined values from the list (use the Add and Delete buttons to control number of values in the list). Each value in the list defines a mode and you can switch between them using method Set???Mode (name of the method depends on the bean).
• from interval: it will be possible to select a new value within a predetermined interval.
  This Runtime setting type requires runtime calculations to change time setting of the bean. The runtime setting type may not be supported on small microcontrollers.

Upper right panel
Value
currently edited time: initialization value, value in any mode from the list or limit of the interval.

• Requested value: write here the value you wish to set and select the unit in the Units list box. If you select the With value check- box, the value is recomputed at every unit change.
  Tip: Double- click on the requested value to see all supported values close to the selected one.
• It is possible to specify desired precision of the timer settings by using one of the following settings (which one is used depends on the type of the timing) :
  • Error allowed - This field allows specifying the tolerated difference between real timing and the requested value. The % check-box allows the user to set the degree of precision as a percentage of the requested value.
  • Min. resolution - Minimal resolution of timer ticks. This setting is used for setting interval or capture bean timing. Allows the user to specify maximal acceptable length of one tick of the timer. In the case of interval settings the % check-box (if it is present) allows the user to set the degree of precision as a percentage of the low limit value. Otherwise the % value is related to the requested value.
• Adjusted value, Prescaler and Error: Shows the real value computed from chosen on-chip peripheral settings, selected Prescaler value and the difference between the value selected by the user and the real value.
• Status line displays status of the timing setting. If the requirements are impossible to meet, a red error message is displayed.

Bottom panel
Possible settings
values supported by the Target CPU for the selected peripheral.

• Closest values: supported time values that are the closest to the requested value.
• Possible in high (and/or low, slow) speed mode: all correct settings in high/low/slow speed mode.
  Tip: Click on any value to see all supported values close to the selected one.
• Overclocked (check-box below for information only): if checked, the bean supports extension of the hardware timing by the 8-bit software counter.
• Intersection of speed modes (check-box below is visible only in EXPERT view mode) if selected the Possible settings box contains only values which are available in all speed modes supported by the bean.

Prescaler

It is possible to set a requested prescaler value in several beans. You can choose "Autoselect" for automatic selection (default value).

Some peripherals support internal prescalers - any other peripheral can divide its clock. You can set this special prescalers in the bean properties - item Prescaler (if supported). The internal prescaler are not used by automatic selection. Internal prescaler peripherals can be selected in other beans as internal prescaler but cannot be used as a peripheral (as an interrupt source).

Figure 1 - Timing Settings Dialog

[top of page]